home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.2 for Intel / NeXTSTEP 3.2 for Intel.iso / NextLibrary / Documentation / Sybase / DBLIB / Section2 / dbiordesc.nr < prev    next >
Encoding:
Text File  |  1993-04-22  |  2.2 KB  |  64 lines
  1. .Na "DBIORDESC    (UNIX only)"
  2. .Aa
  3. .Fu
  4. Provide program access to the UNIX file descriptor used by a
  5. DBPROCESS to read data coming from \*S.
  6. .Ih "file descriptor (UNIX), access to"
  7. .Sy
  8. .Sf "int DBIORDESC(dbproc)"
  9. .Sp "DBPROCESS" "*dbproc"
  10. .Co
  11. .Bl
  12. This routine provides a way for an application to 
  13. respond effectively to multiple input streams.
  14. .Ih "input streams, multiple"
  15. Depending on the nature of your application, 
  16. the time between a request for
  17. information from \*S (usually made via a call to \f2dbsqlsend()\fP)
  18. and \*S's response (read by calling \f2dbsqlok()\fP,
  19. \f2dbresults()\fP, or \f2dbnextrow()\f1) may be significant. You may use this
  20. time to service other parts of your application. The \f2DBIORDESC()\fP
  21. routine provides a way to obtain the I/O descriptor which a DBPROCESS uses
  22. to read the data stream from \*S.
  23. This information
  24. may then be used with various operating system facilities 
  25. (such as the UNIX \f2select()\fP call) 
  26. to allow the application to respond effectively to multiple input streams.
  27. .Bl
  28. The file descriptor returned by this routine may only be used with operating system
  29. facilities that \f2do not\f1 read data from the incoming data stream. If data
  30. is read from this stream by any means other than through a \*L routine, 
  31. communications between the front-end and \*S will become hopelessly scrambled.
  32. .Bl
  33. An application can use
  34. the \*L \f2DBRBUF()\f1 routine,
  35. in addition to the UNIX \f2select()\f1 function,
  36. to help determine whether any more data 
  37. from \*S is available for reading.
  38. .Bl
  39. A companion routine, \f2DBIOWDESC()\f1, provides access to the file descriptor
  40. used to write data to \*S.
  41. .Bl
  42. For an example that illustrates the use of \f2DBIORDESC()\f1 with \f2dbsqlsend()\f1
  43. and \f2dbsqlok()\f1, see the \f2\*L Reference Supplement\f1.
  44. .Bz
  45. .Pa
  46. .Pi dbproc
  47. A pointer to the DBPROCESS structure that provides the connection
  48. for a particular front-end/\*S process.  It contains all the
  49. information that \*L uses to manage communications and data between the
  50. front end and \*S.
  51. .in -.375i
  52. .Re
  53. .br
  54. An integer file descriptor used by the specified DBPROCESS to read data coming from
  55. \*S.
  56. .Sa
  57. dbcmd, 
  58. DBIOWDESC, 
  59. dbnextrow, 
  60. DBRBUF,
  61. dbresults, 
  62. dbsqlok, 
  63. dbsqlsend
  64.